home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dkstat.z / dkstat
Text File  |  1998-10-20  |  7KB  |  198 lines
  1.  
  2.  
  3.  
  4. DDDDKKKKSSSSTTTTAAAATTTT((((1111))))                                                            DDDDKKKKSSSSTTTTAAAATTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddkkkkssssttttaaaatttt - report disk I/O statistics
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ddddkkkkssssttttaaaatttt [----hhhh _h_o_s_t] [----LLLL] [----ffff {rrrr|tttt|ssss}] [----rrrr] [----wwww] [----nnnn _n_d_i_s_k_s] [----cccc] [----aaaa] [----iiii
  13.      _d_e_v_s_p_e_c[,,,,_d_e_v_s_p_e_c ...]]  [----xxxx _d_e_v_s_p_e_c[,,,,_d_e_v_s_p_e_c ...]]  [_i_n_t_e_r_v_a_l [_r_e_p_e_a_t]]
  14.  
  15. TTTTYYYYPPPPIIIICCCCAAAALLLL UUUUSSSSAAAAGGGGEEEE
  16.      To monitor I/O rates on all disks every 5 seconds
  17.  
  18.                dkstat
  19.  
  20.      To continuously display a table of disks on the host "babylon", use the
  21.      following command;
  22.  
  23.                dkstat -c -ft -h babylon
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      ddddkkkkssssttttaaaatttt reports physical disk I/O statistics.  The default report shows
  27.      the average physical I/O rate (requests per second, or IOPS) to each disk
  28.      during the sample _i_n_t_e_r_v_a_l (default 5 seconds).
  29.  
  30.      The options to _d_k_s_t_a_t are as follows;
  31.  
  32.      ----????   Output usage information.
  33.  
  34.      ----hhhh _h_o_s_t
  35.           Report for the host _h_o_s_t, which must be running ppppmmmmccccdddd(1).  The
  36.           default is to report for the local host.
  37.  
  38.      ----LLLL   Report for the local host and by-pass ppppmmmmccccdddd(1).  This option is
  39.           mutually exclusive with the ----hhhh option and is the default if ppppmmmmccccdddd(1)
  40.           is not running.
  41.  
  42.      ----cccc   Invokes continuous mode, using a ccccuuuurrrrsssseeeessss(3) display. This is most
  43.           useful with the "sorted" (----ffffssss) and "table" (----fffftttt) display formats.
  44.  
  45.      ----ffff {rrrr|tttt|ssss}
  46.           Selects the report format as follows:
  47.  
  48.           ----ffffrrrr  selects ``row'' format (one column per drive).  The report is
  49.                sorted on drive name across the page.  This is the default
  50.                display format.
  51.  
  52.           ----fffftttt  selects ``table'' format (one line per controller).  The report
  53.                is sorted on controller name down the page and by drive unit
  54.                number across the page.
  55.                For SCSI devices with non-zero Logical Unit Numbers (LUNs) all
  56.                devices for a single SCSI target address appear in a the same
  57.                row, sorted by LUN.  Down the page, rows are sorted by SCSI
  58.                target within controller.
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. DDDDKKKKSSSSTTTTAAAATTTT((((1111))))                                                            DDDDKKKKSSSSTTTTAAAATTTT((((1111))))
  70.  
  71.  
  72.  
  73.           ----ffffssss  selects ``sorted'' format (one drive per line).  The report is
  74.                sorted for the most active drive, depending on the ----rrrr and ----wwww
  75.                flags.  If neither ----rrrr or ----wwww are given, the report is sorted on
  76.                total number of I/Os (reads plus writes).  The ----nnnn option
  77.                restricts the report to the _n_d_i_s_k_s most active disks (default
  78.                22).  The %%%%BBBBuuuussssyyyy column in the output is the percentage of time
  79.                during the interval that the drive was active.  The MMMMeeeeaaaannnnSSSSTTTT
  80.                column in the output is the average service time of all
  81.                requests which completed during the interval (in units of
  82.                milliseconds).
  83.  
  84.      ----rrrr   Only report reads from each drive.  The default is to sum reads and
  85.           writes.  The ----ffffssss style report will be sorted for the drives which
  86.           perform the most read I/Os per second.
  87.  
  88.      ----wwww   Only report writes to each drive.  The ----ffffssss style report will be
  89.           sorted for the drives which perform the most write I/Os per second.
  90.  
  91.      ----rrrrwwww  Report both reads and writes to each drive.  If neither ----rrrr or ----wwww are
  92.           given, then report total I/Os (reads plus writes).
  93.  
  94.      _i_n_t_e_r_v_a_l [_r_e_p_e_a_t_s]
  95.           Specifies the interval in seconds between successive reports
  96.           (default 5 seconds) and the number of intervals to report (default
  97.           is to repeat forever).  All statistics are averaged over the
  98.           interval.
  99.  
  100. DDDDEEEEVVVVIIIICCCCEEEE SSSSEEEELLLLEEEECCCCTTTTIIIIOOOONNNN
  101.      The ----aaaa flag (default) causes all drives and controllers to be reported
  102.      (depending on the report format).  This may be modified by the ----iiii option
  103.      to include only some drives and exclude all others, or by the ----xxxx option
  104.      to exclude some drives and include all others.
  105.  
  106.      The argument to the ----iiii or ----xxxx option is a comma separated list (without
  107.      spaces before or after each comma) of device specifiers (_d_e_v_s_p_e_c).  A
  108.      _d_e_v_s_p_e_c is a string of characters that might reasonably be expected to be
  109.      the prefix for the names (as report via ----IIII) of one or more devices.
  110.  
  111.      Examples;
  112.  
  113.      ddddkkkkssss1111dddd6666llll3333       SCSI controller 1, target 6, LUN 3.
  114.  
  115.      ddddkkkkssss0000dddd1111         SCSI controller 0, target 1, all LUNs.
  116.  
  117.      ddddkkkkssss4444           All drives on SCSI controller 4.
  118.  
  119.      ddddkkkkssss6666,,,,ddddkkkkssss0000dddd3333    All drives on SCSI controller 6 and SCSI target 3 on SCSI
  120.                     controller 0.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135. DDDDKKKKSSSSTTTTAAAATTTT((((1111))))                                                            DDDDKKKKSSSSTTTTAAAATTTT((((1111))))
  136.  
  137.  
  138.  
  139. SEE ALSO
  140.      ppppmmmmccccdddd(1), ssssaaaarrrr(1), ssssaaaaddddcccc(1), ggggrrrr____ttttoooopppp(1), oooossssvvvviiiieeeewwww(1) and ggggrrrr____oooossssvvvviiiieeeewwww(1).
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                         PPPPaaaaggggeeee 3333
  195.  
  196.  
  197.  
  198.